home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 05.zip / BS1 part 5 / GOD14-(412)695-3647.adf / BBSGuardv1.25.doc.pp / BBSGuardv1.25.doc
Text File  |  1992-08-05  |  10KB  |  201 lines
  1. This program is NOT public domain. This program is copyright.
  2. You may distribute the program freely so long as there is no
  3. charges for the program. Anything above the cost of the media
  4. which it is copied onto or the normal user fee of a bulletin
  5. board system is not allowed. This documentation must accompany
  6. the executable program. No commercial use of this program is
  7. allowed without prior written agreement from the author (me).
  8.  
  9.                                            May 1992 © Darrell Grainger
  10.  
  11.                                    BBSGuard
  12.                                    --------
  13.  
  14. A friend needed a program what would monitor the carrier detect line. If
  15. there was a carrier detect this program would then monitor the line and
  16. time how long the carrier was detected for. By default the program would
  17. reboot the computer after 11600 seconds (3 hours).
  18.  
  19.  The following options are available:
  20.  
  21.          -a       Make the window active when run.
  22.          -b##     Delay between checking for new ring count. Default 10.
  23.          -c##     Number of seconds to abort reboot. default = 30 seconds.
  24.          -d##     Delay before program activates.
  25.          -g       Enable Guru Meditation trapping.
  26.          -n       No requesters. Cancels all requesters.
  27.          -p##     Delay between the ring pulse. Default is 75.
  28.                   This stands for 75/50 or 1.5 seconds.
  29.          -r##     Number of unanswered rings before resetting computer.
  30.                   Default = 5 rings.
  31.          -s##     Set the number of seconds of carrier detect before
  32.                   resetting the computer. Default = 11600 seconds.
  33.          -t##     Delay in seconds between checks for carrier detect.
  34.                   Default = 10 seconds.
  35.          -x##     X position of the window. Default = 0.
  36.          -y##     Y position of the window. Default = 0.
  37.  
  38.  Note: the RI line of the serial port is connected to the SEL line
  39.  of the parallel port. Selecting and deselecting the printer will seem like
  40.  the phone is ringing to this program.
  41.  
  42.  Note: to conserve CPU time this program goes to sleep for 10 seconds
  43.  between checks. So for 10 seconds it will seem as if the program has
  44.  locked up. Always wait 10 seconds for something to happen.
  45.  
  46.                                             1992 © Darrell Grainger
  47.  
  48. I have done a lot of testing with the various options and here is what I
  49. found:
  50.  
  51.          -b       There is ATLEAST 8 seconds between callers. This is a
  52.                   restriction of Bell's phone system. Some phone exchanges
  53.                   take as long as 9 seconds. To be safe I set the default
  54.                   to 10 seconds. This should work fine.
  55.  
  56.          -d       Some BBS programs take a while before they can answer the
  57.                   phone. Run BBSGuard with no -d option. Time how long
  58.                   between when BBSGuard appears and the modem initializes.
  59.                   Whatever the seconds this take is what the -d option
  60.                   should be set to.
  61.  
  62.          -p       I have found that some exchanges ring slightly longer or
  63.                   slightly shorter. This messes me up just a little. If
  64.                   you can, run BBSGuard and have someone call you. BBSGuard
  65.                   will display when it thinks the phone is ringing. If
  66.                   BBSGuard misses some of the rings then set -p to
  67.                   something lower then 75.
  68.  
  69.          -r       Most BBS programs answer on the first or second ring.
  70.                   Most terminal programs, when autodialing, will only let
  71.                   the phone ring 6 or 7 times before hanging up and trying
  72.                   a new number. The default of 5 seemed sensible to me BUT
  73.                   be warned that sometime the BBS will not immediately
  74.                   answer the phone after a user has logged off. One BBS
  75.                   was famous for taking as long as 7 rings before answering
  76.                   if it was busy processing EchoMail.
  77.                   If you are using an Amiga 1000, it has no RI line so you
  78.                   should set this to -r0. If you want to add RI to your
  79.                   Amiga 1000 please contact me and I will send you tested
  80.                   instructions on how to add RI just like a 500/2000/3000.
  81.  
  82.          -s       This value MUST be in seconds. Sorry but I was lazy.
  83.                   The default of 11600 is 3 hours. If you have anyone with
  84.                   access longer then 3 hours you must change this. If
  85.                   everyone's access is less then you can lower the default.
  86.                   Remember that this must be set for the user with the 
  87.                   highest access time plus a few seconds to be safe.
  88.  
  89.          -t       Rather then having the program CONSTANTLY checking the
  90.                   Carrier Detect line you can make my program go to sleep.
  91.                   I found that 10 seconds was long enough that it does not
  92.                   slow the CPU down or affect the BBS but you can make it
  93.                   long if you want. NOTE: if you change this it affects the
  94.                   time you have to wait if you try and quit the program.
  95.  
  96.  The rest of the commands are user definable and should need no further
  97.  explanations.
  98.  
  99.  version 1.25 improvements
  100.  -------------------------
  101.  - If a system Requester occurs the system will sometimes not reboot on the
  102.    failure to answer (ring detect). The -n option will disable all of the
  103.    requesters so even the System Requester will CANCEL (this causes a Guru
  104.    Meditation so the -g option is recommended with this).
  105.  
  106.  version 1.24 improvements
  107.  -------------------------
  108.  - added routines to disable Guru Meditations. If a Guru Meditation occurs
  109.    and the -g option was enabled, the system will automatically reboot
  110.    rather then sit at the flashing red Guru Meditation.
  111.  
  112.  version 1.23 improvements
  113.  -------------------------
  114.  - added a self reboot feature. The program will no longer generates
  115.    a requester that causes "Reboot1.1" to reboot the computer. This
  116.    makes BBSGuard standalone.
  117.  
  118.  - added the -C option so you can have an abort before the thing
  119.    reboots. When the program is about to reboot the title to the window
  120.    will change to the "Double click here to abort". -C will determine
  121.    how long you have to abort the reboot. Default is 30 seconds.
  122.    During the abort/reboot period all screens will flash until you abort
  123.    or the computer reboots. Pressing the left mouse button from ANYWHERE
  124.    will abort the reboot. During ring detect the abort simply sets the
  125.    ring count back to zero. During the carrier detect the abort resets the
  126.    counter of carrier detect seconds back to -S## seconds left.
  127.  
  128.  version 1.22 improvements
  129.  -------------------------
  130.  - made the check for time between rings programmable. If the delay
  131.    between rings is too long we should assume this is a new caller and
  132.    reset the count of how many rings. Default = 10 seconds. If the time
  133.    from start of last ring to start of next ring is greater then 10
  134.    seconds the ring count will reset. This is the -B option.
  135.  
  136.  version 1.21 improvements
  137.  -------------------------
  138.  - found there was a timing problem during the ring detect on some phone
  139.    lines so I made the delay time between ring checks programmable.
  140.    This is option P. Default = 75 (75/50 = 1.5 seconds). This default is
  141.    new and should work on all phone lines. Some phone lines will allow
  142.    you to increase the delay. Try setting the delay to 100, run the
  143.    program, make the phone ring and see if it misses any of the rings.
  144.  - While I was at it I made the delay between checking for carrier
  145.    programmable as well. The bigger this number the less slow down for
  146.    the user online BUT the long the delay should you wish to quit the
  147.    program.
  148.  
  149.  version 1.2 improvements
  150.  ------------------------
  151.  - added a delay option so they program can be made to wait for the BBS
  152.    to power up and initialize.
  153.  - added the -r0 option so the program can disable ring detect. No use
  154.    in wasting CPU time checking for a ring that will not be there.
  155.  - reset the ring counter if there is a 10 second pause between rings.
  156.    I found that the phone rings every 7 to 8 seconds so if there is a
  157.    ten second pause it must be a new caller. This means that ONE caller
  158.    must let the phone ring -R times (default = 5). Don't set that too
  159.    high or this option is pointless.
  160.  
  161.  version 1.1 improvements
  162.  ------------------------
  163.  - optimized code to waste less time when checking for a ring. Program
  164.    now goes to sleep for 2 seconds every loop of the ring detect routine.
  165.    A ringing phone lasts for just over 2 seconds. If the delay is longer
  166.    then 2 seconds there is a good chance the program will miss some rings.
  167.    With a 2 second delay I have only noted it missing the first ring and
  168.    then only when the first ring is a partial ring (less then 2 seconds).
  169.  
  170.  version 1.01 improvements
  171.  -------------------------
  172.  - added a check for the phone ringing and the BBS not answering. If the
  173.    phone rings unanswered for too long then obviously the BBS has crashed.
  174.  
  175.  
  176. Current I can be reached at:
  177.  
  178. darrell.grainger@canrem.uucp     OR
  179.  
  180. telepro!darrell_grainger@access.usask.ca     OR
  181.  
  182. Chaotic Knights BBS (416) 272-1860 - messages to SYSOP are directed to
  183. myself and the actual Sysop.
  184.  
  185. OR
  186.  
  187. Darrell A. Grainger
  188. 48 Wheeler Ave.
  189. Toronto, ON
  190. M4L 3V2  Canada
  191.  
  192.  
  193. If you have any suggestions or find any bugs please drop me a line. I'm
  194. also interested in finding out where this program makes it to, so send
  195. me a postcard or something if you could.
  196.  
  197.  Future plans
  198.  ------------
  199.  - support for the Commodore A2232 card (have to get programming info
  200.    on the card).
  201.